package com.xuetang.service;

import com.xuetang.entity.*;

import java.util.Date;
import java.util.List;
import java.util.Map;

/**
 * 饮食管理服务接口
 */
public interface DietService {

    /**
     * 获取食物类别列表
     * 
     * @return 食物类别列表
     */
    List<DietFoodCategory> getFoodCategories();

    /**
     * 根据类别ID获取食物列表
     * 
     * @param categoryId 类别ID
     * @param page       页码
     * @param pageSize   每页数量
     * @return 食物列表及分页信息
     */
    Map<String, Object> getFoodsByCategory(Integer categoryId, Integer page, Integer pageSize);

    /**
     * 搜索食物
     * 
     * @param keyword  关键词
     * @param page     页码
     * @param pageSize 每页数量
     * @return 食物列表及分页信息
     */
    Map<String, Object> searchFoods(String keyword, Integer page, Integer pageSize);

    /**
     * 获取食物详情
     * 
     * @param id 食物ID
     * @return 食物详情
     */
    DietFood getFoodDetail(Integer id);

    /**
     * 添加食物
     * 
     * @param food 食物信息
     * @return 添加成功返回true，否则返回false
     */
    boolean addFood(DietFood food);

    /**
     * 更新食物
     * 
     * @param food 食物信息
     * @return 更新成功返回true，否则返回false
     */
    boolean updateFood(DietFood food);

    /**
     * 删除食物
     * 
     * @param id 食物ID
     * @return 删除成功返回true，否则返回false
     */
    boolean deleteFood(Integer id);

    /**
     * 获取用户指定日期的饮食记录
     * 
     * @param userId 用户ID
     * @param date   日期
     * @return 饮食记录
     */
    DietRecord getDietRecord(Long userId, Date date);

    /**
     * 获取用户饮食记录列表
     * 
     * @param userId    用户ID
     * @param startDate 开始日期
     * @param endDate   结束日期
     * @param page      页码
     * @param pageSize  每页数量
     * @return 饮食记录列表及分页信息
     */
    Map<String, Object> getDietRecords(Long userId, Date startDate, Date endDate, Integer page, Integer pageSize);

    /**
     * 添加饮食记录
     * 
     * @param record  饮食记录
     * @param details 饮食记录明细列表
     * @return 添加成功返回true，否则返回false
     */
    boolean addDietRecord(DietRecord record, List<DietRecordDetail> details);

    /**
     * 更新饮食记录
     * 
     * @param record  饮食记录
     * @param details 饮食记录明细列表
     * @return 更新成功返回true，否则返回false
     */
    boolean updateDietRecord(DietRecord record, List<DietRecordDetail> details);

    /**
     * 删除饮食记录
     * 
     * @param id 记录ID
     * @return 删除成功返回true，否则返回false
     */
    boolean deleteDietRecord(Long id);

    /**
     * 获取推荐食谱列表
     * 
     * @param page     页码
     * @param pageSize 每页数量
     * @return 食谱列表及分页信息
     */
    Map<String, Object> getRecommendRecipes(Integer page, Integer pageSize);

    /**
     * 根据餐类型获取食谱列表
     * 
     * @param mealType 餐类型
     * @param page     页码
     * @param pageSize 每页数量
     * @return 食谱列表及分页信息
     */
    Map<String, Object> getRecipesByMealType(String mealType, Integer page, Integer pageSize);

    /**
     * 获取食谱详情
     * 
     * @param id 食谱ID
     * @return 食谱详情
     */
    DietRecipe getRecipeDetail(Integer id);

    /**
     * 添加食谱
     * 
     * @param recipe  食谱信息
     * @param details 食谱明细列表
     * @return 添加成功返回true，否则返回false
     */
    boolean addRecipe(DietRecipe recipe, List<DietRecipeDetail> details);

    /**
     * 更新食谱
     * 
     * @param recipe  食谱信息
     * @param details 食谱明细列表
     * @return 更新成功返回true，否则返回false
     */
    boolean updateRecipe(DietRecipe recipe, List<DietRecipeDetail> details);

    /**
     * 删除食谱
     * 
     * @param id 食谱ID
     * @return 删除成功返回true，否则返回false
     */
    boolean deleteRecipe(Integer id);

    /**
     * 获取用户饮食统计数据
     * 
     * @param userId    用户ID
     * @param startDate 开始日期
     * @param endDate   结束日期
     * @return 统计数据
     */
    Map<String, Object> getDietStats(Long userId, Date startDate, Date endDate);

    /**
     * 获取食物总数
     * 
     * @return 食物总数
     */
    int countFoods();

    /**
     * 获取食谱总数
     * 
     * @return 食谱总数
     */
    int countRecipes();

    /**
     * 获取指定日期范围内的饮食记录总数
     * 
     * @param startDate 开始日期
     * @param endDate   结束日期
     * @return 记录总数
     */
    int countDietRecords(Date startDate, Date endDate);

    /**
     * 获取最近添加的食物
     * 
     * @param limit 数量限制
     * @return 食物列表
     */
    List<DietFood> getRecentFoods(int limit);

    /**
     * 根据ID获取饮食记录
     * 
     * @param id 记录ID
     * @return 饮食记录
     */
    DietRecord getDietRecordById(Long id);

    /**
     * 获取饮食记录的明细列表
     * 
     * @param recordId 记录ID
     * @return 饮食记录明细列表
     */
    List<DietRecordDetail> getDietRecordDetails(Long recordId);
}